NavCompleteSave

NavCompleteSave
Header:	Navigation.h		Carbon status:	Supported

Completes a save operation and performs any needed translation on the file.

OSErr NavCompleteSave (
    NavReplyRecord *reply, 
    NavTranslationOptions howToTranslate
);

Parameter descriptions

reply: A pointer to a structure of type NavReplyRecord. Upon return, Navigation Services uses this structure to provide data to your application about the results of your NavCompleteSave call.
howToTranslate: A pointer to a structure of type NavTranslationOptions. Pass one of two values to specify how to perform any needed translation. For a description of the constants you can use to represent these values, see “Translation Option Constants”. Translating in-place causes the source file to be replaced by the translation. Translating to a copy results in a file name followed by the string “(converted)” to avoid unwanted replacement. If you call the NavCompleteSave function in response to a Save a Copy command, you should pass the kNavTranslateInPlace constant in this parameter.

function result: A result code. Since this function performs any needed translation, it may return a translation error.

DISCUSSION

You should always call NavCompleteSave to complete any file saving operation performed with the NavPutFile function. NavCompleteSave performs any needed translation, so you do not have to use the function NavTranslateFile when saving. If you wish to turn off automatic translation, set to false the value of the translationNeeded field of the NavReplyRecord structure you pass in the reply parameter of the NavPutFile function. If you turn off automatic translation, your application is responsible for any required translation. For more information, see “Saving Files”.

See also “Translating Files on Save”.

VERSION NOTES

Available in Navigation Services 1.0 and later.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.